home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / windows / games / tif2win.exe / BIT2WP.DOC next >
Text File  |  1989-12-03  |  8KB  |  269 lines
  1.  
  2.                         BIT2WP V1.0 BIT/RLE Image File
  3.                                       to
  4.                      Word Processor Image File Translator
  5.                      Copyright 1989 by William J. Hinkle
  6.  
  7.                             === User's Guide === 
  8.  
  9. The BIT2WP program was created to allow image files from Lotus Manuscript,
  10. or from other conversion utilities, to be used by other word processing 
  11. programs that handle graphics, and in other graphics programs.  To do this, 
  12. BIT2WP translates these BIT/RLE files into any of several other graphics file 
  13. formats.  You can translate to:
  14.  
  15. * .WPG files (Word Perfect 5 graphics format)
  16. * .TIF files (Aldus/Microsoft TIFF format)
  17. * .BIT or .RLE files (Lotus Manuscript graphics format)
  18. * .IMG files (GEM Paint format)
  19. * .GIF files (CompuServe Graphics Interchange Format)
  20. * .PCX files (PC Paintbrush PCX Format)
  21.  
  22. The translator is a single file: BIT2WP.EXE.  The default translation is to 
  23. Word Perfect (.WPG) format.
  24.  
  25. ==============
  26. COPYRIGHT INFO
  27. ==============
  28. This utility program BIT2WP.EXE was written by
  29.  
  30.     William J. Hinkle
  31.  
  32. who retains the copyright.  Copy and use the program freely.  Distribute
  33. it to whomever you want.  But:
  34.  
  35. === Do NOT distribute modified versions.
  36. === Do NOT remove the copyright notice.
  37. === ALWAYS distribute with the documentation.
  38. === DO NOT charge a fee, except for disk copying/library charges.
  39.  
  40. If you feel that this program has been of some utility, please remit
  41. a contribution of $10.00 to help defray my costs run up in developing
  42. this utility.  You will receive a written receipt.
  43.  
  44. William J. Hinkle
  45. 420 E.Boston Mills Rd.
  46. Hudson, OH 44236-1111
  47.  
  48.  
  49.  
  50. ===============
  51. BASIC OPERATION
  52. ===============
  53.  
  54. To create a .WPG file (the default), type in:
  55.  
  56. BIT2WP fname1
  57. or
  58. BIT2WP fname1.BIT
  59. or
  60. BIT2WP fname1.BIT fname2.WPG
  61.  
  62. from the DOS command prompt.
  63.  
  64. * For "fname1", substitute the name of your BIT file, of course!
  65.   You must spell out the .RLE extension if an RLE file is to be converted.
  66.   Note that Lotus Manuscript .SCG files are the same as .BIT files.
  67.  
  68. * The .BIT and .WPG extensions are assumed if something else is not specified.
  69.  
  70. * The .WPG file name is made the same as the .BIT file name if not otherwise 
  71. specified.  Specify a different "fname2" if desired.
  72.  
  73. * Full DOS pathnames can be specified.  If you enter a directory (ending in \) 
  74. or a drive (ending in :) for the second ("fname2") filename, the output file 
  75. will be placed on that path with the default filename; i.e, the input filename 
  76. with a .WPG extension.
  77.  
  78. The .BIT file will be translated to a .WPG file.
  79.  
  80. The .BIT file will not be erased.  You can also specify scaling factors, but
  81. the defaults work the best (see below).
  82.  
  83.  
  84.  
  85. ==================
  86. OTHER FILE FORMATS
  87. ==================
  88.  
  89. To create a new graphics file in one of the other supported formats, you must 
  90. specify the other format.  You have two ways to do this.  One way is to 
  91. specify the output filename ("fname2") with the appropriate extension.  The 
  92. other is to specify the special /f option switch that selects the desired
  93. format.  The second method is usually the best, because the .BIT file's 
  94. filename is then automatically used for the output file.
  95.  
  96. Some examples:
  97.  
  98. ---
  99.  
  100. * To get a Aldus/Microsoft TIFF file:
  101.  
  102. BIT2WP fname1 /ft
  103. or
  104. BIT2WP fname1.BIT fname2.TIF
  105.  
  106. gives you a TIFF file.
  107.  
  108. ---
  109.  
  110. * To get an uncompressed (BIT) Lotus Manuscript graphics file:
  111.  
  112. BIT2WP fname1 /fr
  113. or
  114. BIT2WP fname1.BIT fname2.RLE
  115.  
  116. ---
  117.  
  118. * To get a compressed (RLE) Lotus Manuscript graphics file:
  119.  
  120. BIT2WP fname1 /fr
  121. or
  122. BIT2WP fname1.BIT fname2.RLE
  123.  
  124. NOTE: Be careful how you specify your filenames for cross-converting BIT/RLE
  125. files.  You must not overwrite the input file, so be sure to specify the
  126. correct output filename or format.  BIT2WP makes sure you haven't specified
  127. the same filename for input and output files, but it can be tricked, so be
  128. careful!
  129.  
  130. ---
  131.  
  132. * To get a GEM Paint graphics file:
  133.  
  134. BIT2WP fname1.BIT fname2.IMG
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141. ---
  142. * To get a CompuServe GIF file:
  143.  
  144. BIT2WP fname1 /fg
  145. or
  146. BIT2WP fname1.BIT fname2.GIF
  147.  
  148. ---
  149.  
  150. * To get a ZSoft PC Paintbrush PCX file
  151.  
  152. BIT2WP fname1 /fp
  153. or
  154. BIT2WP fname1.BIT fname2.PCX
  155.  
  156.  
  157.  
  158. ==============
  159. COMPLEAT USAGE
  160. ==============
  161.  
  162. If you invoke BIT2WP from DOS without any other parameters, it will display 
  163. the following help message.  This illustrates some of the other options you 
  164. can select with command line switches.
  165.  
  166. -----
  167. BIT/RLE-to-WP Image File Translator: V1.0 ... Copyright 1989 by W.J.Hinkle
  168.  
  169. Usage: BIT2WP fname1 [fname2] [options] ...
  170. where: fname1.BIT ... Lotus Manuscript BIT input file
  171.    or  fname1.RLE ... Lotus Manuscript RLE input file
  172.        fname2.WPG ... Word Perfect 5 WPG output file (default)
  173.    or  fname2.TIF ... Aldus/Microsoft TIFF format output file
  174.    or  fname1.BIT ... Lotus Manuscript BIT output file
  175.    or  fname1.RLE ... Lotus Manuscript RLE output file
  176.    or  fname2.IMG ... GEM IMG format output file
  177.    or  fname2.GIF ... CompuServe GIF format output file
  178.    or  fname2.PCX ... PC Paintbrush PCX format output file
  179.  
  180. Command Line Options:
  181.        /xN        ... option: x density = N pixels-per-inch
  182.        /yN        ... option: y density = N lines-per-inch
  183.        /v         ... option: reverse video
  184.        /fw        ... option: force WPG (Word Perfect) output file
  185.        /ft        ... option: force TIFF output file
  186.        /fb        ... option: force BIT (Lotus Manuscript) output file
  187.        /fr        ... option: force RLE (Lotus Manuscript) output file
  188.        /fi        ... option: force IMG (GEM) output file
  189.        /fg        ... option: force GIF (CompuServe) output file
  190.        /fp        ... option: force PCX (PC Paintbrush) output file
  191.  
  192. BIT2WP is a translator from Lotus Manuscript BIT/RLE image files
  193. to various other word processor image file formats:
  194.  
  195. To Word Perfect 5 WPG files (fname2.WPG, or use /fw option),
  196. or Microsoft/Aldus TIFF files (fname2.TIF, or use /ft option),
  197. or Lotus Manuscript BIT/RLE files (fname2.BIT/RLE, or use /fb, /fr options),
  198. or GEM IMG files (fname2.IMG, or use /fi option),
  199. or CompuServe GIF files (fname2.GIF, or use /fg option),
  200. or PC Paintbrush PCX files (fname2.PCX, or use /fp option).
  201.  
  202. Shareware by: William J. Hinkle CIS [71121,3211]
  203. This utility may be distributed with other graphics converters by:,
  204.  
  205. William J. Hinkle
  206. 420 E.Boston Mills Road
  207. Hudson, OH 44236
  208. -----
  209.  
  210.  
  211.  
  212. =============
  213. REVERSE VIDEO
  214. =============
  215.  
  216. Normally BIT2WP keeps black and white the same between the BIT/RLE file and the
  217. output file.  If you want a reverse video effect, use the /v option switch.
  218.  
  219. ==================
  220. SIZING AND DENSITY
  221. ==================
  222.  
  223. Normally BIT2WP make a output file with the same image density as the 
  224. original scan.  This lets your program compute the "natural" size of the 
  225. graphics image.  You can specify a different density by specifying it with 
  226. either the /x or /y option switches (e.g. /x200 is 200 pixels and lines per 
  227. inch).  You can also alter the aspect ratio (to "stretch" the image one way or 
  228. the other) by specifying both the /x and the /y option switches, with 
  229. different density values.
  230.  
  231. Of course, you can usually scale the image in your other application program.
  232.  
  233.  
  234.  
  235. ======
  236. HELP?!
  237. ======
  238.  
  239. Should you have any difficulties using this program, please 
  240. contact me via Compuserve EasyPlex (or on the CompuServe PICS forum):
  241.  
  242. William J. Hinkle [71121,3211]
  243.  
  244. ======
  245. THANKS
  246. ======
  247.  
  248. Thanks to:
  249.  
  250. Tom Pfau, for his public domain LZW compression/decompression code
  251.  
  252. ==========
  253. LEGALITIES
  254. ==========
  255. Manuscript is a trademark of the Lotus Development Corporation.
  256. Word Perfect is a trademark of the Word Perfect Corporation.
  257. GEM is a trademark of the Digital Research Corporation.
  258. GIF and 'Graphics Interchange Format' are trademarks of CompuServe Inc.,
  259.  an H & R Block Company.
  260. PC Paintbrush is a trademark of ZSoft Corporation.
  261.  
  262. *************************************************************************
  263. *    Revision History:                                                    *
  264. *    -----------------                                                    *
  265. *    Version number    Date        Explanation                                *
  266. *    --------------    ------        --------------------------                *
  267. *        1.0            03 Dec 89    first public release                    *
  268. *************************************************************************
  269.